Open JUMP urn GIS 100% Java 

A 10 anos um sonho hoje uma realidade 

Ezequias Rocha 

Um Desktop GIS 100% Java hoje e possivel gracas a um grupo de visionarios que hoje 
repete o que fizeram os grandes gigantes do passado. 

Ha aproximadamente 3 anos, mais especificamente em 17 de Outubro de 2002, quando surgiram as 
primeiras ideias de um sistema de informacoes geograficas versatil, poderoso e ricamente portatil, nao se 
imaginava o que em 2006 ele pudesse vir a se tornar em um sistema altamente amado por seus usuarios. 
Entre seus fans estao o governo Canadense, empresas de tecnologia alema, o Japao e por que nao o 
Brasil. 

Tudo comecou com uma demanda do Ministerio de Ontario, mais especificamente com o departamento 
de Recursos Naturais da Columbia Britanica no Canada. A demanda bancada pelo governo canadense se 
assemelha ao que aconteceu nos primordios da tao conhecida ESRI, lider mundial em Geoprocessamento. 
Assim como na decada de 80 em 2002 iniciava-se um processo sem volta. Hoje os desafios sao 
basicamente os mesmos mas o caminho para o sucesso do OpenJUMP nao sera tao arduo como foi para 
os precursores dos Sistemas de Informacao Geografica. 

A rica jornada deste bravo software comeca com a solicitacao para que a Vivid Solutions, empresa de 
software do Canada, viesse a desenvolver um sistema GIS feito totalmente em Java e com sua interface 
aberta para extensoes. Um nucleo enxuto e uma capacidade de importar Pluglns ainda hoje faz sucesso. 
Inicialmente chamado apenas de JUMP - Jump Unified Mapping Plataform (Plataforma de Mapeamento 
Unificada Jump) o JUMP cumpriu sua meta e apos seu periodo de maturacao seu codigo foi gentilmente 
cedido a comunidade. 




Figura 1. Empresa desenvolvedora da solugao JUMP 

Outras versoes de JUMP apareceram desde entao desde o JUMP internacional (JUMP-il8n) ate versoes 
de outras empresas que moldaram-o ao seu bel prazer. O deeJUMP, o Jump da Agiles, Jump-SIGLE 
(frances) e o OpenJUMP, versao da comunidade. Assim como aconteceu com o OpenOffice, que adveio 
do StarOffice e esta antenado com os padroes do mercado o OpenJUMP juntou tudo que ha de mais 
atrativo em diversas versoes sem perder a classe do projeto original. 

Ate o presente momento as versoes nao modificaram muito seu nucleo robusto baseado em tres pilares 
fortes e distintos. Sua API e composta basicamente da JTS, da JCS e o JUMPWorkbench. Vamos 
descrever todas elas mostrando como tirar proveito deste conjunto de bibliotecas robustas e altamente 
uteis. 



API JUMP 


Conjunto de APIs que suportam entrada/saida de dados espaciais, feicoes e colecoes que 
fundamentalmente processam algoritimos espaciais baseados no modelo geometrico 


JUMPWorkbench 


O JUMPWorkbench e uma interface interativa que prove um framework para a execuijao de 
funcoes espaciais e visualizacao de resultados. Ela pove muitas ferramentas de cria9ao, 
visualiza<;ao e manipulacao do dado espacial. 



A API do OpenJUMP 



1. A JTS - Suite Topologica Jump, implementa as funcionalidade topologicas conhecidas pelos 
especialistas em GIS por seus padroes de Ponto, Linha e Poligono bem como suas inter relacoes (quern 
esta contido em quern, quern toca quern, quern sobrepoe-se a quern) e seus padroes de formatacao de 
dados proprietaries e livres (Shapefile e o GML + JML). 

2. A JCS - Suite de Conflitamento Jump, implementa toda a camada de conflitamento, informando que 
elementos graficos nao estao de acordo com as especificacoes do mercado. Ela tambem pode efetuar uma 
checagem a posteriori com base em parametros passados pelo usuario (como uma linha de ate lOOKm 
reais) e depois informar onde estao os conflitamentos. 

3. O JUMPWorkbench e a interface grafica que torna tudo isso possivel ao simples clique de um mouse. 
Desenvolvido principalmente pelo programador canadense Jonathan Aquino, o Workbench facilita e 
muito a vida de quern visualiza e analisa e edita o dado geografico diariamente. 

Os desenvolvedores iniciais do projeto conclamam aos seus usuarios para utiliza-lo de 3 formas distintas 
e ao mesmo tempo complementares. Pode-se dizer que o JUMP e afins pode ser utilizado como uma API 
geografica, como um kit de ferramentas ou como uma filosofia. Hoje o Recife implementa um projeto 
inovador dando visibilidade a este projeto com essas tres finalidades basicas. 
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Figura 2. Framework do JUMP 



0 Caso do Recife 



O Recife, que no final da decada de 80 implementava um projeto estruturador baseado em Sistemas de 
Informacao Geografica sempre com softwares proprietaries veio por conhecer todo o mundo do GIS livre 
a partir do ano de 2005. Antes disso solucoes livres nunca haviam sido cogitadas. E este cenario mudou e 
a EMPREL - Empresa Municipal de Informatica, como sempre, primou por analisar todas as 
possibilidades antes de continuar a enveredar por sistemas nao livres. 

Ao analisar-se diversos softwares livres desenvolvidos em C++, Visual Basic, e ate Bibliotecas Java, a 
direcao da empresa optou finalmente por centrar seus esfor?os no OpenJUMP no desktop. Por tudo que o 



Java representa e por ser o nosso padrao o software foi estudado com maior afinco nos ultimos meses do 
ano pela sua equipe. Poder estuda-lo, reprograma-lo, extende-lo e dissemina-lo fez os nossos olhos 
brilharem e ele comecou a ser uma alternativa real e imediata. 

Confesso que mesmo sendo aberto a novidades, fiquei um pouco receoso do real poder do software. 
Mesmo assim sendo nossa direcao nao recuou diante de tantos desafios. Foram efetuados diversos testes 
de performance e confiabilidade e basicamente todas as extensoes foram tratadas nos testes (3D com o 
Java 3D, Raster GIS com o Java Advanced Image -JAI) e servicos de mapas e o acesso a bancos foram 
validados. O OpenJUMP nao e uma simples ferramenta de visualizacao de dados espaciais, ele e uma 
realidade quer queiram ou nao. 

O projeto de disseminar o OpenJUMP na prefeitura do Recife (com populacao de mais de 1.500.000 
habitantes) nos credita a informar que e o maior projeto de software livre em GIS do Brasil. O cadastro 
imobiliario da cidade ira conter tambem ferramentas beans advindos de outra API, o Geotools e ira se 
tornar em um marco em cadastros imobiliarios no pais. 



Porque Java ? 



Nossa empresa ja conta com um know-how em desenvolvimento Java/GIS desde a primeira 
implementacao do Cadastro Imobiliario do Recife (CI) baseada em MapObjects (uma tambem bem 
sucedida implementacao Java para geoprocessamento). 

Com uma comunidade altamente participativa e acolhedora, avancamos muito e acreditamos que 
avancaremos muito mais na implementacao de novas funcionalidades para o OpenJUMP. Hoje ja existe 
na empresa um conjunto de extensoes que esta sendo implementado diariamente desde o final de 2005. 

A comunidade esta crescendo a pacos largos e uma pergunta nao fica sem resposta, seja para discutir 
questoes inerentes ao projeto seja para sanar problemas de programacao. O grande numero de 
programadores Java em relacao aos programadores C e nossos cases de sucesso fizeram-nos concluir que 
teremos um grande e duradouro caminho a percorrer tanto como o OpenJUMP como com o Java. 



Construindo um Plugln para o JUMP 



Vamos aqui criar nossa primeira extensao e ver como e facil se incorporar a interface grafica do sistema. 
Iremos criar um JInternalFrame que ira interagir com o clique do menu que sera inserido ao ja existente. 
Seu nome sera "HelloWorldPlugln.jar". 



O processo de criacao de extensoes (Pluglns) para o OpenJUMP e 
bastante simples, basta apenas empacotar seu programa Java e copia-lo 
para o diretorio lib/ext da instalacao do software. Imediatamente o 
Plugln ira ser carregado na proxima carga do sistema. 




Primeiramente gostariamos de relatar nosso expressivo agrado pela ferramenta Eclipse e por sua 
facilidade na implementacao de interfaces graficas e por sua robustez. Tanto plugins como aplicacoes 
disfarcadas de plugins foram produzidas e distribuidas utilizando-se das facilidades dele. 

E importante salientar, antes de mais nada, que diversos Plugins j a foram produzidos e que no site 
www.OpenJUMP.org encontra-se uma gama enorme de extensoes. Muitos deles estao com seu codigo 
fonte disponivel e pronto para o reuso. Esta reusabilidade esta nos ajudando muito aqui na empresa. 

Entao vamos ao codigo: 

Listagem 1. HelloWorldExtension.java: extensao que ira carregaro plugin na GUI 

package com . yourcompany ; 

import com . vividsolutions . j ump . workbench . plugin . Extension; 
import com . vividsolutions . j ump . workbench . plugin . PluglnContext ; 

/ * * 

* @description 

* - esta classe carrega o Plugin dentro do Jump <p> 

* - esta classe tern que ser chamada de "Extension" no fim do nome da classe 

* para que possamos usa-lo dentro do Jump 

* @author ezequias 
*/ 

public class HelloWorldExtension extends Extension) 
/ * * 

* chama o Plugin usando o metodo xplugin . initialize ( ) 

V 

public void configure ( PluglnContext context) throws Exception) 
new HelloWorldPlugln ( ) . initialize (context) ; 

} 

} 

Listagem 2. HelloWorldPlugln. java: e o codigo que sera executado quando o plugin for chamado no menu 

package com . yourcompany ; 

import com . vividsolutions . j ump . workbench . plugin . Abstract Plugin; 
import com . vividsolutions . j ump . workbench . WorkbenchContext ; 
import com . vividsolutions . j ump . workbench . plugin . EnableCheckFactory ; 
import com . vividsolutions . j ump . workbench . plugin . MultiEnableCheck; 
import com . vividsolutions . j ump . workbench .plugin . PluglnContext ; 
import com . vividsolutions . j ump . workbench . ui . plugin . Feature Ins taller; 

public class HelloWorldPlugln extends AbstractPlugln { 

public HelloWorldPlugln ( ) { 
// construtor vazio 

} 

public void initialize (PluglnContext context) throws Exception { 

Featurelnstaller f eaturelnstaller = new Featurelnstaller ( context 

. getWorkbenchContext ( ) ) ; 
featurelnstaller . addMainMenuItem (this, // exe 

new String)] { "View" }, // menu path 

this . getName ( ) , // metodo .getName recebido por 



/ / AbstractPlugln 

false, // checkbox 
null, // icone 

/ / enable check 
createEnableCheck (context . getWorkbenchContext ( ) ) ) ; 



public static MultiEnableCheck createEnableCheck ( 
WorkbenchContext workbenchContext) { 
EnableCheckFactory checkFactory = new EnableCheckFactory ( 
workbenchContext) ; 

return new MultiEnableCheck ( ) . add ( checkFactory 

. createWindowWithLayerNamePanelMustBeActiveCheck ( ) 

} 

/ * * 

* Acao no item do menu: cria urn novo documento a exibir 
*/ 

public boolean execute (PluglnContext context) throws Exception { 



context . getWorkbenchFrame ( ) . getOutputFrame ( ) . createNewDocument ( ) ; 
context . getWorkbenchFrame ( ) . getOutputFrame ( ) . addText ( "Ola Mundo ! " ) ; 
context . getWorkbenchFrame ( ) . getOutputFrame ( ) . surface ( ) ; 



return true; 



Distribuindo nosso primeiro Plugln 



Agora vamos ve-lo em funcionamento no OpenJUMP. Utilizaremos o 
Eclipse por ser o que escolhemos aqui em nosso projeto. Ele tern uma 
ferramenta nativa de deployment bastante simples. 

1° Passo: Importar Pacotes da API do JUMP 

•Clique com o botao direito no Projeto que voce criou no Eclipse 

•Escolha o item Java Build Path 

•Escolher a aba Libraries 

•Clique no botao Add External JARs... 

•Selecionar os jars na pasta lib onde voce instalou o OpenJUMP 

previamente 

•Clique em OK 

2° Passo: Distribuindo o Plugln 

Depois de escrever o codigo conforme as listagens 1 e 2, citadas voce 
pode exporta-lo como um ".jar" clicando com o botao direito em 
Projectl e escolhendo a opcao Export . . . 
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Figura 3. Seu projeto de Pluglns com as bibliotecas do JUMP 
Apos a escolha por exportar voce deve dizer ao Eclipse que formado sera exportado seu codigo. Escolha 
a op?ao JAR file e clique em Next 



Verifique se todas as classes que existem em 
nosso Plugln estao selecionadas na caixa de 
checagem a esquerda no item Select the 
resources to export: e passe para o ultimo passo. 

Ainda na mesma janela, so que agora no item 
JAR file: defina em que diretorio ira salvar o seu 
Plugln. 

No nosso caso a exportacao vai parar no diretorio 
onde o OpenJUMP foi instalado. Fizemos desta 
forma para que voce ja veja, logo ao iniciar o 
OpenJUMP se seu plugin foi distribuido 
corretamente. 

Agora clique no botao Finish para concluir a 
exportacao e terminar o processo de criacao do 
nosso primeiro Plugln. 
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Select an export destination: 
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JAR Package Specification 

Define which resources to package into which JAR. 



Figura 4. Selecione JAR file para ir para o ultimo passo antes de testa-lo 

% 3° Passo: Testando-o 



Select the resources to export: 



T Htfprojectl 
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0 Export generated class files and resources 

□ Export all output folders for checked projects 

□ Export java source files and resources 

Select the export destination: 



Agora que o Plugln foi criado e instalado, 
podemos agora ir a passo final colocando o 
OpenJUMP em acao. 

Vamos inicia-lo ? 

Antes disto vamos tomar cuidado para que ele 
fique no idioma ingles setando o parametro de 
internacionalizacao -H8n en no script de 
inicializacao do programa (JUMPWorkbench.bat 
ou JUMPWorkbench-unix.sh), na pasta \bin, com 
um editor de texto. 

Agora sim inicie o OpenJUMP. Em sua 
inicializacao voce o vera sendo carregado na tela 
splash. 

Voce vera um menu View um item a mais 
chamado HelloWorldPlugln que ira abrir um 
JInternalFrame boa sorte programadores, todos 

Figura 5. Defina aqui que classes serao exportadas e onde salvar seu Plugln 

sao bem vindos no projeto. Muitas das suas duvidas podem ser tiradas na lista de discussao do JUMP ou 
na Wiki page do projeto. 



JAR file: /usr/local/jump/lib/ext/HelloWori4jar 



Options: 

0 Compress the contents of the JAR file 

0 Add directory entnes 

0 Overwrite existing files without warning 
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Caracteristicas gerais do OpenJUMP 



Vamos listar aqui algumas das caracteristicas gerais alcancadas pelo projeto. Dentre muitas de suas 
funcionalidades podemos destacar: 

•Capacidade de abrir e editar dados geograficos no formato shapefile (formato amplamente 
utilizado hoje) 

•Capacidade de abrir e gerar arquivos geograficos em conforme com os padroes OGC 
•Facil exibigao, manipulagao e exportagao de dados geograficos 
•Leitura de bases no PostgreSQL/PostGIS 

•Ferramentas de analise espacial como Uniao, Intersegao, Sobreposigao, Translagao etc 
•Leitura de imagens de satelite (Raster com o arquivo worldfile atraves de Plugln) 
•Edigao de mapas e de atributos relacionados a ele 
•Ligagao Mapa atributo e atributo mapa 
•Ferramentas de navegagao (zoom/pan) 

•Capacidade de ler servigos de Servidores de Mapas WMS e WFS (com Plugln) 
•Vasta biblioteca de Pluglns 



Veremos agora a interface grafica do projeto. 
Tela Principal 



| File Liln View Ldyei junli Ejmiiel H iiiiluw Help 



,Menu Bar 



Open JUMP 

PI*] 1 1MB 2 



6 |3 4» 



© 



0 

1 ^ ~ Category Tree : :. : : : : : ;: : .: ; :. .: r : : : :. : Plug-in Button 

j 1 WliKlliq 



V\ lotes 
0 mub 
v Bairros 



Attribute £k 
Window 



iCt 

Win Jow 



D3 Attributes: eaitros 



□ 2 




Bairros (94 Features) 

FID IBA1RR0S. BAIRROS.ID | 
1 
2 
3 

4 

5 
6 
7 
3 



Number Selected: 0 



ME Committed Memory 



(PSaia7,5, 9110933 



Figura 6. Nivel atual da interface grafica do OpenJUMP 



0 OpenJUMP em agao 
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Figura 8. Aqui abrindo uma imagem associada ao mapa [Plugln genuinamente nacional] 



Links 



www. openjump. org 

Wiki page do Projeto 
www.jump-project. org 

Website do Projeto Inicial (O JUMP) 
www.vividsolutions.com 

Empresa desenvolvedora do JUMP 

Ezequias Rodrigues da Rocha (ezequias@recife.pe.gov.br, www.recife.pe.gov.com) e Analista de Sistemas, trabalha com 
geoprocessamento desde 1998 quando elaborou o primeiro trabalho com GIS aplicado a Defesa Civil. Trabalha hoje na EMPREL - 
Empresa Municipal de Informatica, vinculada a prefeitura do Recife, com sistemas livres aplicados a Sistemas de Informacao Geografica. 



